Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Working With Channel Characteristics

SGSetChannelVolume

The SGSetChannelVolume function sets a channel's sound volume.

pascal ComponentResult SGSetChannelVolume (SGChannel c,
                                           short volume);

c

Specifies the reference that identifies the channel for this operation. You obtain this reference from the SGNewChannel function, described on page 5-29.

volume

Specifies the volume setting of the channel represented as a 16-bit, fixed-point number. The high-order 8 bits contain the integer part of the value; the low-order 8 bits contain the fractional part. Volume values range from -1.0 to 1.0. Negative values play no sound but preserve the absolute value of the volume setting.

DESCRIPTION

The sequence grabber component uses this volume setting during playback--this setting does not affect the record level or the volume of the track in the recorded QuickTime movie.